﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>WinActivate</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link href="../css/commands.css" rel="stylesheet" type="text/css">
<link href="../css/print.css" rel="stylesheet" type="text/css" media="print">
</head>
<body>

<h1>WinActivate</h1>

<p>激活匹配指定条件的窗口（将它置于最前端）。</p>

<p class="CommandSyntax">WinActivate [, WinTitle, WinText, ExcludeTitle, ExcludeText]</p>
<h3>参数 </h3>
<table border="1" width="100%" cellspacing="0" cellpadding="3" bordercolor="#C0C0C0">
  <tr> 
    <td width="15%">WinTitle</td>
    <td width="85%">目标窗口的标题或标题中的部分文字（匹配模式由 <a href="SetTitleMatchMode.htm">SetTitleMatchMode</a> 决定）。如果省略所有的参数，默认目标是 <a href="../LastFoundWindow.htm">上一次匹配窗口</a> 。要用窗口的 class 名进行匹配，使用 <em>ahk_class 精确 class 名</em>（Window Spy 中可以显示 class 名）。要用窗口的 <a href="Process.htm">进程标识符（PID）</a>进行匹配，使用 <em>ahk_pid %PID变量%</em> 。要用 <a href="GroupAdd.htm">窗口组</a> ，使用 <em>ahk_group 组名</em> 。要用窗口的 <a href="WinGet.htm">唯一 ID</a> 进行匹配，使用 <em>ahk_id %ID变量%</em> 。要减小检测范围，使用 <a href="../LastFoundWindow.htm#multi">多重条件</a> ，例如：<em>My File.txt ahk_class Notepad</em></td>
  </tr>
  <tr> 
    <td>WinText</td>
    <td>如果使用这个参数，则它应该是目标窗口中某个文本元素的子字符串（在 Window Spy 中会显示出窗口中的文本元素）。隐藏文本只有在 <a href="DetectHiddenText.htm">DetectHiddenText</a> 设置为 ON 的时候才能检测到。</td>
  </tr>
  <tr>
    <td>ExcludeTitle</td>
    <td>标题中包含该参数指定的文字的窗口将被除外。</td>
  </tr>
  <tr>
    <td>ExcludeText</td>
    <td>文本元素中包含该参数指定的文字的窗口将被除外。</td>
  </tr>
</table>

<h3>注意</h3>
<p>如果窗口处于最小化状态，它首先会还原到原来的状态，再被激活。</p>
<p>在 60ms 中，脚本会对目标窗口的激活进行 6 次尝试。因此，一般情况下在 WinActivate 命令之后不需要使用 <a href="WinWaitActive.htm">WinWaitActive</a> 命令。</p>
<p>如果匹配的窗口已经处于激活状态，那么它会继续保持激活状态，脚本不会再去激活其它的匹配窗口。一般情况下，如果匹配的窗口不止一个，处于最前端（最近使用）的窗口将被激活。也可以使用 <a href="WinActivateBottom.htm">WinActivateBottom</a> 激活最底端（最久一次使用）的窗口。</p>
<p>如果一个窗口紧接着另一个窗口的激活事件之后被激活，任务栏可能会闪烁（取决于系统和设置）。要防止这种现象，使用 <a href="_WinActivateForce.htm">#WinActivateForce</a> 。</p>
<p>窗口的标题和窗口中的文字是大小写敏感的。要检测隐藏窗口，必须打开 <a href="DetectHiddenWindows.htm">DetectHiddenWindows</a> 。</p>

<h3>相关命令</h3>
<p><a href="WinActivateBottom.htm">WinActivateBottom</a>, <a href="_WinActivateForce.htm">#WinActivateForce</a>, <a href="SetTitleMatchMode.htm">SetTitleMatchMode</a>, <a href="DetectHiddenWindows.htm">DetectHiddenWindows</a>, <a href="../LastFoundWindow.htm">Last Found Window</a>, <a href="IfWinExist.htm">IfWinExist</a>, <a href="IfWinActive.htm">IfWinActive</a>, <a href="WinWaitActive.htm">WinWaitActive</a>, <a href="WinWait.htm">WinWait</a>, <a href="WinWaitClose.htm">WinWaitClose</a>, <a href="WinClose.htm">WinClose</a>, <a href="GroupActivate.htm">GroupActivate</a>, <a href="WinSet.htm">WinSet</a></p>
<h3>示例</h3>
<pre class="NoIndent">IfWinExist, Untitled - Notepad
    WinActivate <em>; 使用上一句找到的窗口</em>
else
    WinActivate, Calculator</pre>

</body>
</html>
